Inside Macintosh: QuickDraw GX Environment and Utilities /

Chapter 3 - Errors, Warnings, and Notices / Errors, Warnings, and Notices Reference

Constants and Data Types

Errors

QuickDraw GX provides you with an extended set of errors in the debugging version and a reduced set of errors in the non-debugging version. Each QuickDraw GX error constant has an error number described by the gxGraphicsError type definition and the gxGraphicErrors enumeration:

typedef long gxGraphicsError;
enum gxGraphicErrors {

   /* truly fatal errors */
   out_of_memory = -27999,
   internal_fatal_error,
   no_outline_font_found,
   not_enough_memory_for_graphics_client_heap,
   could_not_create_backing_store,

   /* internal errors */
   internal_error = -27950,
   internal_font_error,
   internal_layout_error,
   
   /* recoverable errors */
   could_not_dispose_backing_store = internal_layout_error + 2,
   unflattening_interrupted_by_client,

   /* font manager errors */
   font_cannot_be_changed,
   illegal_font_parameter,

   /* gxFont scaler errors */
   null_font_scaler_context = -27900,
   null_font_scaler_input,
   invalid_font_scaler_context,
   invalid_font_scaler_input,
   invalid_font_scaler_font_data,
   font_scaler_newblock_failed,
   font_scaler_getfonttable_failed,
   font_scaler_bitmap_allocation_failed,
   font_scaler_outline_allocation_failed,
   required_font_scaler_table_missing,
   unsupported_font_scaler_outline_format,
   unsupported_font_scaler_stream_format,
   unsupported_font_scaler_font_format,
   font_scaler_hinting_error,
   font_scaler_rasterizer_error,
   font_scaler_internal_error,
   font_scaler_invalid_matrix,
   font_scaler_fixed_overflow,
   font_scaler_api_version_mismatch,
   font_scaler_streaming_aborted,
   unknown_font_scaler_error,

   /* bad parameters */
   parameter_is_nil = -27850,
   shape_is_nil,
   style_is_nil,
   transform_is_nil,
   ink_is_nil,
   transferMode_is_nil,
   color_is_nil,
   colorProfile_is_nil,
   colorSet_is_nil,
   spoolProcedure_is_nil,
   tag_is_nil,
   type_is_nil,
   mapping_is_nil,
   invalid_viewDevice_reference,
   invalid_viewGroup_reference,
   invalid_viewPort_reference,
   
   /* implementation limits */
   number_of_contours_exceeds_implementation_limit = -27800,
   number_of_points_exceeds_implementation_limit,
   size_of_polygon_exceeds_implementation_limit,
   size_of_path_exceeds_implementation_limit,
   size_of_text_exceeds_implementation_limit,
   size_of_bitmap_exceeds_implementation_limit,
   number_of_colors_exceeds_implementation_limit,
   procedure_not_reentrant

   #ifdef debugging
   ,
   /* internal debugging errors: following available only in */
   /* the debugging init */
   functionality_unimplemented = -27700,
   clip_to_frame_shape_unimplemented,
   
   /* font parameter debugging errors */
   illegal_font_storage_type,
   illegal_font_storage_reference,
   illegal_font_attributes,

   /* parameter debugging errors */
   parameter_out_of_range,
   inconsistent_parameters,
   index_is_less_than_zero,
   index_is_less_than_one,
   count_is_less_than_zero,
   count_is_less_than_one,
   contour_is_less_than_zero,
   length_is_less_than_zero,
      
   invalid_client_reference,
   invalid_graphics_heap_start_pointer,
   invalid_nongraphic_globals_pointer,

   colorSpace_out_of_range,

   pattern_lattice_out_of_range,
   frequency_parameter_out_of_range,
   tinting_parameter_out_of_range,
   method_parameter_out_of_range,
   space_may_not_be_indexed,
   

   glyph_index_too_small,
   no_glyphs_added_to_font,
   glyph_not_added_to_font,
   point_does_not_intersect_bitmap,

   required_font_table_not_present,
   unknown_font_table_format,

/* the styles encoding is not present in the font */
   shapeFill_not_allowed,
   inverseFill_face_must_set_clipLayer_flag,
   invalid_transferMode_colorSpace,
   colorProfile_must_be_nil,
   bitmap_pixel_size_must_be_1,
   empty_shape_not_allowed,
   ignorePlatformShape_not_allowed,
   nil_style_in_glyph_not_allowed,
   complex_glyph_style_not_allowed,
   invalid_mapping,
      
   cannot_set_item_shapes_to_nil,
   cannot_use_original_item_shapes_when_growing_picture,
   cannot_add_unspecified_new_glyphs,
   cannot_dispose_locked_tag,
   cannot_dispose_locked_shape,
   
   /* restricted access */
   shape_access_not_allowed,
   colorSet_access_restricted,
   colorProfile_access_restricted,
   tag_access_restricted,
   viewDevice_access_restricted,
      
   graphic_type_does_not_have_a_structure,
   style_run_array_does_not_match_number_of_characters,
   rectangles_cannot_be_inserted_into,
      
   unknown_graphics_heap,
   graphics_routine_selector_is_obsolete,
   cannot_set_graphics_client_memory_without_setting_size,
   graphics_client_memory_too_small,
   graphics_client_memory_is_already_allocated,
      
   viewPort_is_a_window,

   /* wrong type/bad reference */
   illegal_type_for_shape,
   shape_does_not_contain_a_bitmap,
   shape_does_not_contain_text,
   picture_expected,
   bitmap_is_not_resizable,
   shape_may_not_be_a_bitmap,
   shape_may_not_be_a_picture,
   graphic_type_does_not_contain_points,
   graphic_type_does_not_have_multiple_contours,
   graphic_type_cannot_be_mapped,
   graphic_type_cannot_be_moved,
   graphic_type_cannot_be_scaled,
   graphic_type_cannot_be_rotated,
   graphic_type_cannot_be_skewed,
   graphic_type_cannot_be_reset,
   graphic_type_cannot_be_dashed,
   graphic_type_cannot_be_reduced,
   graphic_type_cannot_be_inset,
   shape_cannot_be_inverted,
   shape_does_not_have_area,
   shape_does_not_have_length,
   first_glyph_advance_must_be_absolute,
   picture_cannot_contain_itself,
   viewPort_cannot_contain_itself,
      
   cannot_set_unique_items_attribute_when_picture_
   contains_items,
   layer_style_cannot_contain_a_face,
   layer_glyph_shape_cannot_contain_nil_styles,

      /* validation errors */
   object_wrong_type,
   shape_wrong_type,
   style_wrong_type,
   ink_wrong_type,
   transform_wrong_type,
   device_wrong_type,
   port_wrong_type,


   /*cache validation errors */
   shape_cache_wrong_type,
   style_cache_wrong_type,
   ink_cache_wrong_type,
   transform_cache_wrong_type,
   port_cache_wrong_type,
   shape_cache_parent_mismatch,
   style_cache_parent_mismatch,
   ink_cache_parent_mismatch,
   transform_cache_parent_mismatch,
   port_cache_parent_mismatch,
   invalid_shape_cache_port,
   invalid_shape_cache_device,
   invalid_ink_cache_port,
   invalid_ink_cache_device,
   invalid_style_cache_port,
   invalid_style_cache_device,
   invalid_transform_cache_port,
   invalid_transform_cache_device,
   recursive_caches,

   /*shape cache validation errors */
   invalid_fillShape_ownerCount,
   recursive_fillShapes,

   /*memory block validation errors */
   indirect_memory_block_too_small,
   indirect_memory_block_too_large,
   unexpected_nil_pointer,
   bad_address,

   /* object validation errors */
   no_owners,
   invalid_pointer,
   invalid_seed,
   invalid_frame_seed,
   invalid_text_seed,
   invalid_draw_seed,
   bad_private_flags,

   /* path and polygon validation errors */
   invalid_vector_count,
   invalid_contour_count,
   /* validation bitmap errors */
   bitmap_ptr_too_small,
   bitmap_ptr_not_aligned,
   bitmap_rowBytes_negative,
   bitmap_width_negative,
   bitmap_height_negative,
   invalid_pixelSize,
   bitmap_rowBytes_too_small,
   bitmap_rowBytes_not_aligned,
   bitmap_rowBytes_must_be_specified_for_user_image_buffer,

   /* bitmap validation image errors */
   invalid_bitImage_fileOffset,
   invalid_bitImage_owners,
   invalid_bitImage_rowBytes,
   invalid_bitImage_internal_flag,

   /* text validation errors */
   text_bounds_cache_wrong_size,
   text_metrics_cache_wrong_size,
   text_index_cache_wrong_size,

   /* glyph validation errors */
   glyph_run_count_negative,
   glyph_run_count_zero,
   glyph_run_counts_do_not_sum_to_character_count,
   glyph_first_advance_bit_set_not_allowed,
   glyph_tangent_vectors_both_zero,

   /* layout validation errors */
   layout_run_length_negative,
   layout_run_length_zero,
   layout_run_level_negative,
   layout_run_lengths_do_not_sum_to_text_length,

   /* picture validation errors */
   bad_shape_in_picture,
   bad_style_in_picture,
   bad_ink_in_picture,
   bad_transform_in_picture,
   bad_shape_cache_in_picture,
   bad_seed_in_picture,
   invalid_picture_count,

   /* text face validation errors */
   bad_textLayer_count,
   bad_fillType_in_textFace,
   bad_style_in_textFace,
   bad_transform_in_textFace,

   /* transform validation errors */
   invalid_matrix_flag,
   transform_clip_missing,

   /* font cache validation errors */
   metrics_wrong_type,
   metrics_point_size_probably_bad,
   scalar_block_wrong_type,
   scalar_block_parent_mismatch,
   scalar_block_too_small,
   scalar_block_too_large,
   invalid_metrics_range,
   invalid_metrics_flags,
   metrics_maxWidth_probably_bad,
   font_wrong_type,
   font_wrong_size,
   invalid_font_platform,
   invalid_lookup_range,
   invalid_lookup_platform,
   font_not_in_font_list,
   metrics_not_in_metrics_list,

   /* view device validation errors */
   bad_device_private_flags,
   bad_device_attributes,
   invalid_device_number,
   invalid_device_viewGroup,
   invalid_device_bounds,
   invalid_bitmap_in_device,
   /* color set validation errors */
   colorSet_wrong_type,
   invalid_colorSet_viewDevice_owners,
   invalid_colorSet_colorSpace,
   invalid_colorSet_count,


   /* color profile validation errors */
   colorProfile_wrong_type,
   invalid_colorProfile_flags,
   invalid_colorProfile_response_count,

   /* internal backing store validation errors */
   backing_free_parent_mismatch,
   backing_store_parent_mismatch
   #endif
   };

QuickDraw GX non-debugging errors are listed in the section "Errors" beginning on page 3-6. Debugging errors are listed in the section "Errors" beginning on page 3-6.